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INTRODUCTION 


SMARTBUG is a 1024 byte monitor program which may be used 

in most systems using the Motorola 6800 microprocessor. 

It was designed primarily to replace the MIKBUG ROM used 

in many systems including the Southwest Technical Products 
6800 microcomputer. SMARTBUG is available from SMOKE SIGNAL 
BROADCASTING on a 2708 EPROM. In order to implement SMARTBUG 
in the SWIPC 6800 microcomputer system, SMOKE SIGNAL BROAD- 
CASTING has developed the P-38 series of EPROM boards. 

These boards are equipped with SMARTBUG and contain room 

for seven more 2708's so that the user can expand the monitor 
at any time. : 


Most of the SMARTBUG subroutines start at the same address 
locations as the functionally equivalent MIKBUG subroutines. 
Thus, most programs designed to run with MIKBUG should require 
little, if any, modification to run with SMARTBUG. 


One major advantage of SMARTBUG is that it is available on a 
2708 Eraseable-Programmable Read Only Memory Chip. This 
means that the user may easily change the monitor to suit 
his individual system requirements simply by re-programming 
the 2708. 


WHY SMARTBUG? 


SMARTBUG has several new features not found in MIKBUG which 
make system operation easier; however, these are not the 
primary reasons for SMARTBUG, but are added bonuses. MIKBUG 
handles serial I/O through the 6820 Parallel Interface Adapter 
which was designed for 8 bit parallel I/O and not serial I/o. 
MIKBUG requires the 6800 microprocessor to wait in timing 
loops while inputting or outputting data through the PIA. 
Thus, while the processor is writting a character, it cannot 
check to see if the user wishes to input a chafacter at the 
same time. This limitation becomes quite noticeable to the 
user when trying to interrupt a program listing in BASIC 

(or any program that checks for user input while outputting 
data) by typing "CONTROL C". Many "C" keys haye been worn 
out trying to get the program to recognize the|user input. 
Also, while the processor is spinning its wheels in 1/0 
timing loops, it cannot be doing any other work although 
this is usually unimportant except in real-time applications 
requiring fast servicing of interrupt requests. 


SMARTBUG handles I/O through the 6850 Asynchronous Communi- 
cations Interface Adapter. The 6850 was designed specifically 
to handle serial data. When writting data to the 6850, all 


the microprocessor needs to do is check to see that the 6850 

is ready to receive data and then write an 8 bit word to the 
6850 in parallel form over the ‘system data bus. This takes 

only a few instructions and very little time. While the 6850 

is converting the parallel data received from the microprocessor 
to serial and sending it to the output device, it can simul- 
taneously receive data. Thus, if you are running BASIC and 

type a "CONTROL C", the processor is "instantaneously" able 

to respond to your interrupt the first time you type "CONTROL 
Ce. 


Another advantage of handling serial I/O through an ACIA is 
that baud rates in excess of 19,200 can be accomodated 
compared to a maximum baud rate of about 1200 baud that can 
be handled by MIKBUG. 


WHY MIKBUG? 


To the experienced hobbiest who has used MIKBUG, the’ limitations 
of handling serial I/O through a 6820 parallel I/O chip are 
intuitively obvious. If you are a newcomer, just accept it 

on faith that only a very strange person would use a 6820 for 
serial I/O instead of a 6850 in a general purpose microcomputer 
system. The question that is often asked is: "Why would a 

big company like Motorola do such a silly thing?". The answer 
is that in 1974 when MIKBUG was written, the 6850 was not 

yet in production and the 6820 was. In order to introduce 

the first 6800 evaluation kit, it was necessary to handle the 
serial I/O through a 6820 and MIKBUG was a very clever little 
device used to demonstrate how easy it was to use the 6800 
microprocessor. 


HARDWARE REQUIREMENTS 


SMARTBUG "talks" through a 6850 ACIA which should be located 
at $8008 and $8009. It also requires RAM at $A000 through 
$A06B. SMARTBUG itself is located at $E000 through SE3FF. 
In order to have the reset and interrupt vectors operate 
without external ROM, it is necessary to have SMARTBUG 
located at $FC00 through S$FFFF in addition to $E000 through 
SE3FF. The SMOKE SIGNAL BROADCASTING P=-38 series of ,EPROM 
boards has a switch to allow SMARTBUG to occupy both ' of 
these areas or only the $E000 through S$E3FF area when using 
another 2708 in the $FC00 through S$FFFF area. To locate a 
6850 ACIA at $8008 and $8009, owners of the SWTPC 6800 should 
purchase a MP-S board and place it in I/O slot number 2, 

The MP-C control board in slot number 1 is no longer ‘used 
and should be removed from the machine. 


USE OF HIGH BAUD RATES 


The maximum baud rate useable with MIKBUG is about 1200 baud. 
With SMARTBUG, it is possible to use baud rates of at least 
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19,200; however, ror baud rates in excess of about 1200 

baud, it may be necessary to change the crystal in the 

SWIPC 6800. The MC14411P baud rate generator chip used 

in the SWTPC 6800 is designed to use a crystal frequency 

of 1.8432 MHz. The crystal supplied with the SWTPC 6800 

is a few percent lower in frequency due to an anomoly of 
MIKBUG. If you wish to take full advantage of SMARTBUG 

and use it's high baud rate capability, you may need a 
crystal of the correct frequency. Also, it will be necessary 
to bring the desired baud rate line out from the baud rate 
generator chip on the CPU board in place of one of the lower 
baud rates that you are not using. This requires a foil 

cut and jumper on the CPU card. Consult the CPU card instruc- 
tion manual and the MC14411P data sheet to determine the 
correct locations for your particular application. 


SOFTWARE OPERATION 
RESET 


Pressing the reset button on the SWIPC 6800 will cause 
SMARTBUG to output a carriage return, line feed and an 
asterisk (*) to the system terminal. As in MIKBUG, the 
asterisk is the prompt character; and, when it appears, 
SMARTBUG is waiting for the user to enter a command.. One 
of the advantages of having your monitor in EPROM is that 
you are able to customize the monitor to your system. 
When SMARTBUG prompts with an asterisk, it is actually 
outputting the character string located at $E3F0 through 
SE3F6. If you are using a non-scrolling terminal such as 
the CT-1024, you may wish to change oneof the null (00) 
characters in this string to an "Erase to End of Line" 
character ($15 in the case of the CT-1024). 


COMMANDS 


After being prompted with an asterisk, the user may enter 
any valid SMARTBUG command. All SMARTBUG commands are 
single-letter commands followed, in some cases, by address 
information. The valid command letters are A, B,C,D,E,G, 
H,I,d,K,L,M,N,P,Q,R,T,X,4. Entering any other character 
will cause SMARTBUG to prompt again with an asterisk. 


"R" REGISTERS 


Typing "R" will cause SMARTBUG to display the various 
registers in the 6800 in the following format. 


*R CC BB AA XXXX PCPC SPSP 


Throughout this manual, user input is indicated by underlined 
characters. Output from SMARTBUG is not underlined. 


Cc is the two hex digits representing the contents of the 
Condition Code Register : 

BB is the contents of the B Accumulator 

AA is the contents of the A Accumulator 

XXXX is the contents of the Index Register (4 hex digits) 

PCPC is the contents of the Program Counter 

SPSP is the contents of the Stack Pointer 


"A" EXAMINE AND CHANGE THE A ACCUMULATOR 
EEE ALC UNMULATOR 


Entering an "A" after the * prompt character will cause the 
contents of the A Accumulator to be displayed. To change 

the contents of the A Accumulator, simply type two hex 
characters. Type a carriage return to return to SMARTBUG 
without altering the contents of the A Accumulator. A sample 
format is shown below. 


*A XX YY 


where XX is the old contents of the A Accumulator and YY is 
the new contents entered by the user. 


"B" _EXAMINE AND CHANGE THE B ACCUMULATOR 
— ee ee BS ACCUMULATOR 


"B" allows the user to examine and change the contents of 
the B Accumulator and Operates in the same manner as the 
"A" command. 


"C" EXAMINE AND CHANGE THE CONDITION CODE REGISTER 
EEE EVE LURE, REGISTER 


"C" allows the user to examine and change the Condition Code 
Register and operates in the same manner as the "A" command. 


"X""_EXAMINE AND CHANGE THE INDEX REGISTER 


"X" allows the user to examine and change the contents of 

the Index Register. This command operates in the same manner 
as the "A" command except that four hex characters are | 
required for the "X" command instead of two. 


us ) MEMORY EXAMINE AND CHANGE 


t 
a 
‘The "M" command allows the user to examine any memory location 
and to change any memory location occupied by RAM memory. 

To examine a memory location, type "M" followed by the four 
hex digits of the memory location you wish to examine. 


EXAMPLE: *M 0100 
*0100 7E BD 
*0101 El 


In the above example, the user typed "M" followed by "0100". 
SMARTBUG then typed *0100 7E. 7E was the old contents of 
0100. The user then typed "BD", thus changing the contents 
of 0100 to BD. SMARTBUG then proceeded to show the user 
the contents of 0101. 


To change a memory location, it is only necessary to type the 
two hex digits representing the new data. To return to 
SMARTBUG without changing the data, type a carriage return. 
To examine the following location without changing the 
present location, hit the SPACE BAR. To examine the pre- 
vious memory location, type "U" for up. 


GO TO USER'S PROGRAM 


Two commands. are provided to transfer control from SMARTBUG 
to a user's program. The "G" command which operates in 

the same manner as the "G" command in MIKBUG and a new "J" 
command, 


"G"__GO TO LOCATION CONTAINED IN $A048 and $A049 


To use the "G" command, first use the "mM" command to put 
the starting address of the program into memory locations 
$A048 and $A049. Then type "G". SMARTBUG will then jump 
to the location contained in $A048 and $A049. This command 
is useful when you will enter the program several times 
from SMARTBUG. When you only intend to enter the program 
from SMARTBUG once, the "J" command is more convenient. 


"J" JUMP TO LOCATION XXxx 


Typing "J" "XXXX" where XXXX are four hex digits will cause 
SMARTBUG to transfer program control to that location. 
EXAMPLE: *J 01A0 will cause SMARTBUG to jump td $01A0 and 


begin executing whatever program was previously stored 
beginning at that location. 


"I" INSERT 


FORMAT: I XXXX YYYY 22 EXAMPLE: *I 0000 3FFF 3F 

This command will insert the two hex digits "zz" into 
memory locations "XXXX" through "YYYY". In the example, 
memory locations $0000 through $3FFF will now contain $3F,. 

In debugging a new program, it is often desireable to store 
$3F (software interrupt) in all your memory prior to loading 
and executing the program. If the program inadvertantly 
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transfers outside the program area, it will encounter a 
software interrupt, display the CPU registers and return 

to SMARTBUG. This command can also be used to clear blocks 
of memory by storing "00" into specified areas of memory. 


("9" J QUICKSTART 


This command is for the convenience of those people using the 
SMOKE SIGNAL BROADCASTING BFD-68 Disc System. Typing "Q" 
does the same thing as typing "J 8020". SMARTBUG transfers 
control to $8020 which is the beginning address of the 
routine that boots in the disc operating system from a 

cold start. 


(er, DISC 


Typing "D" transfers control from SMARTBUG to $7283 which 
is the warmstart address of DOS68, the disc operating 
system used with the BFD-68 disc system. This provides a 
convenient means of re-entering the DOS68 monitor from 
SMARTBUG when DOS68 has previously been booted in from disc 
and is resident in memory. Those people using the optional 
version of DOS68 located between D000 and DFFF will want to 
te-program the 2708 and change location $E3DF from $72 to 
$D2. Typing "D" will then trasfer program control to $D283 
which is the warmstart address of the optional version of 
DOS68, 


a — wast 
“E") ECHO, “N" /NO-ECHO, (uy) HARDCOPY 
SF re 


ee a” 

RAM location $A00B is a "flag" location that determines 
whether INEEE will echo back characters typed on the terminal 
and whether OUTEEE will output to the system terminal con- 
nected to I/O port number 2 (ACIA at $8008 and $8009) or 

jump to an external output routine. The external output 
routine would normally be a routine to drive a hardcopy 
printer, INEFE is a subroutine located at SEIAC that waits 
for a character input from the system console and returns 
that character input in the A accumulator. OUTEEE is located 
at $E1D1 and causes a character in the A accumulator to be 
transmitted to the system console (or to the external print 
routine). 


i. 


When hitting "RESET" or otherwise entering SMARTBUG at SEODO, 
location $A00B is cleared. Typing an "E" will also clear 
this location. When location $A00B contains a "00", all 
input through INEEE will be echoed through the system console 
and calls to OUTEEE will result in output to the system 
console and not a jump to an external printer output routine, 


NOTE: Many programs have been written that re-enter MIKBUG 
upon completion of the program at "START" location SEODO. 
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Normally, it is better to re-enter MIKBUG or SMARTBUG at 
"CONTRL" location $E0E3. Entering at "CONTRL" will not 
re-initialize $A00B to the ECHO mode, but will leave it in 
the mode last selected by the user or the user's program. 
This is usually more desireable. While MIKBUG does not 
have an echo control feature, there are some other reasons 
why it is usually better to re-enter MIKBUG or SMARTBUG 

at $E0E3 rather than $E0D0. Also, remember that hitting 
"RESET" restores the echo. Unless this is your desired 
mode of operation, you will have to type "N" or "H" after 
pressing "RESET", 


Any positive number ($01 through $7F) stored in S$A00B will 
cause INEEE not to echo the character inputted through INEEE 
and OUTEEE will not jump to an external print routine. 

Typing "N" stores a $4E in location $A00B and, thus, suppresses 
the echo. 


Any negative number ($80 through $FF) stored in SAO0B will 
cause OUTEEE to jump to S$A04A before anything is transmitted 
to the terminal device. Typing "H" stores a $B8 in location 
$A00B and, therefore, will cause OUTEEE to jump to SA04A. 
Any user wishing to use the "H" command will have to put 

a jump to his printer routine location in location $A04a, 
$A04B and $A04C prior to using this feature. Those SMARTBUG 
users having a SMOKE SIGNAL BROADCASTING P-38 series EPROM 
board will probably want to put their printer routine in 
EPROM. Then the printer routine will always be available 
without having to load it into RAM each time the system is 
powered up. The next EPROM location available on the P-38 
board is $E400 through S$E7FF. We suggest standardizing on 
$E600 as the beginning location of the print routine. This 
leaves $E400 through $E5FF available for extended monitor 
routines. If you do put your printer routine at $E600, 

you will probably want to change SMARTBUG location $E1D7 
from $A0 to SE6 and location $E1D8 from $4A to $00. This 
will cause OUTEEE to jump directly to your routine at $E600 
instead of to $A04A. This again points out the advantage of 
having the system monitor in EPROM rather than ROM. With 
EPROM, it is easy to customize the system monitor to your 
unique system requirements, 


If you want OUTEEE to output both to the system console 
as well as to your separate hardcopy device when in the 
"H" mode, your print routine should end with a jump to 
SE1D9. Otherwise, it should end with a "RTS" ($39). 


CONTROL OF THE ECHO FUNCTION FROM THE USER'S PROGRAM 
SS ELE CE VOER SS PROGRAM 


Several programs such as BASIC and DOS68 turn the MIKBUG 
echo off prior to jumping to INEEE and restore the echo 

Upon return, This allows the program to echo control charac- 
ters and other normally non-printable characters. This is 
also probably the only Major area where SMARTBUG and MIKBUG 
are not compatible. In MIKBUG, the echo is suppressed by 
storing a $3C in location $8007 and is restored by storing 
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$34 in location $8007. Running a program that suppresses 

the MIKBUG echo in SMARTBUG without first modifying the 

echo handling routine will result in the input being double 
echoed unless you type a "N" prior to entering these programs. 
For frequently used programs, it will probably be more 
convenient to modify them than to remember to type "N". 


To modify an existing program, we suggest that you change 
the instructions storing a $3C in $8007 to an "INC $A00B" 
(7C AO OB) and that the instruction storing a $34 in $8007 
be changed to a "DEC $AQ00B" (7A AO 0B). NOP's ($01) should 
be used to fill in the extra area used by the previous in- 
structions. , 


In DOS68, the echo control is found in the ZLINEI routine. 
The jump to ZLINEI is found in the jump table at $72B5 
(or $D2B5). Echo is turned off by the instruction sequence 
86 3C B7 80 07 and turned back on by the sequence 86 34 B7 
80 07. These sequences should be changed to 7C AO 0B 01 Ol 
and 7A AO OB 01 O01 respectively. The exact location of 
the ZLINEI routine may vary with different versions of DOS68, 
but the jump table location will remain the same. This is 
why we ask you to go to the jump table to find ZLINEI and 
search through ZLINEI for this instruction sequence rather 
than specify the locations to be changed. 


By using an increment-decrement scheme to control the echo, 

the user now has control of the echo even if he has selected 

the "H" HARDCOPY function prior to entering his program. 

The first part of the printer routine should test to see if 

$A00B contains a $B8. If it does, the routine should output data 
given it. If it contains a $B9, the routine should do a 

"RTS" without outputting the data. 


"P" PUNCH FORMATTED TAPE 
——__<UNCH FORMATTED TAPE 
EXAMPLE: ¥*P 0100 0150 


The above example will cause SMARTBUG to punch a formatted 
tape containing the data in memory locations $0100 through 
$0150. The tape format is the same as the MIKBUG format and 
S9 is not punched at the end. This way, several areas of 
memory may be punched on one tape and loaded with one "1," 
command. At the end of the last area of memory to be punched 
to the tape, the user should manually type a S9 to the ‘tape 
so that the "L" command will function automatically. 


"L" LOAD FORMATTED TAPE 
— EE ee AP 


Typing "L" will turn on the system tape reader and read 
formatted tape produced by the "P" command. If the tape does 
not contain a 89 as an end of file indicator, it will be 
necessary for the user to manually type a S9 on the system 
console after the tape has been read in order to return to 
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SMARTBUG. The S9 causes SMARTBUG to be entered at "CONTRL". 
This is to be preferred over hitting "RESET" which causes 
entry at "START", 


Unlike MIKBUG, SMARTBUG normally echoes the tape input. 
If the user wishes to suppress the echo when loading tape, 
he should type "N" prior to typing "L", 


"4" JUMP TO $E400 


Typing a "4" will cause SMARTBUG to jump to $E400. This 
command allows users of the SMOKE SIGNAL BROADCASTING P38 
series boards to expand their SMARTBUG monitor to include 
additional commands by installing another 2708 EPROM in the 
$E400 through $E7FF socket on the board. The user can 
accomodate additional commands by having a routine starting 
at $E400 that asks for an additional character input and 
then executes whatever command is specified by that second 
character. Using this approach, all regular SMARTBUG commands 
would continue to be one character commands and all extended 
commands would be two character commands with the number "4" 
being the first character. 


We would very much appreciate a copy of any extended commands 
you may develop. Naturally, we would prefer a fully-commented 
source listing; however, don't be embarrassed to send just 

the object code along with a brief functional description. 
After all, it seems most of us write programs first and 
document them later (and then, only if absolutely necessary). 


"K" _ BREAKPOINT 


The "K" command is a tool to allow the programmer to step 
through his program a few steps at a time in order to 

inspect his program at these intermediate steps to see if 

the program is, indeed, operating as it was so carefully 
designed to do. To use the "K" command, first load the 
starting address of the program into memory locations $A048 
and $A049 using the "M" command. Next decide where you 

want the first breakpoint. Then type "K" followed by the 
four hex digits representing the address at which the 
breakpoint is to be inserted. After entering the fourth 
digit, SMARTBUG will jump to the location previously stored 
in $A048 and $A049 and execute the program until it encounters 
the breakpoint (if it ever does). When the breakpoint 

is encountered, SMARTBUG will display the contents of the 
registers in the same format as the "R" command. To continue 
the program at the point it was interrupted, simply type 

"6G". To pick up at this point and continue to a second 
breakpoint, type "K" followed by a new breakpoint address. 


SMARTBUG uses the "SWI" ($3F) instruction to set a breakpoint; 
thus, a breakpoint May not be set in an area of Read-Only- 
Memory. SMARTBUG remembers the instruction stored in the 
breakpoint location and automatically restores that instruction 
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after encountering the breakpoint. If the program "gets 
lost" and the breakpoint is not encountered, the instruction 
will not be restored and will have to be manually restored 
by the user. 


"T" TRACE MODE 


Typing a "T" followed by a four digit hexadecimal address 

puts SMARTBUG in the single~step trace mode. This allows 

the user to step through a program in RAM one step at a 

time and to examine and change the registers after each 

step. Stepping to a ROM location will cause SMARTBUG to 
return to the regular command mode and prompt with an asterisk. 
After typing "T" followed by four hex digits, SMARTBUG 

will type the current contents of the registers followed 

by the specified address and the command to be executed at 
that address. No asterisk prompt character is issued which 
indicates that SMARTBUG is in the TRACE mode. Prior to 
executing the next instruction, the user may change the 

A, B, C or X registers with the A, B, C or X commands. 

When ready to execute the next instruction, hit the SPACE BAR. 
To return to the regular SMARTBUG mode, hit the carriage 
return. Following is the trace output from a very short 
program. 


MEMORY CONTENTS: 0100 86 
0101 43 
0102 BD 
0103 O1 
0104 Dl 
0105 86 
0106 55 
0107 3F 
01D1 39 


*T 0100 

FO 33 00 E26E 0100 A049 
0100 86 43 

SPACEBAR : 
FO 33 43 E26E 0102 A049 
0102 BD O1D1 

SPACEBAR 

FO 33 43 E26E 01D1 A047 
01D1 39 

B33 48 

SPACEBAR 

FO 48 43 E26E 0105 A049 
0105 86 55 

SPACEBAR 

FO 48 55 E26E 0107 A049 
0107 3F 

SPACEBAR 

* 


The format for the listing of the register contents is the 
same as in the "R" command. 


. 
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IRQ AND NMI 


If the system encounters an IRQ interrupt request, it will 
jump to the location contained in memory locations $A000 and 
$A001. An NMI interrupt will cause SMARTBUG to jump to the 
location contained in memory locations $A006 and $A007. If 
the user anticipates these types of interrupts, he should 
initialize these locations early in his program. Alternately, 
he can re-program the vector locations in SMARYTBUG to go 

to permanent interrupt handling routines in his system. 


COMPATIBILITY WITH MIKBUG 


Every reasonable effort was made to keep the subroutines 

in SMARTBUG at the same beginning address locations as 

the functionally equivalent subroutines in MIKBUG so that 
programs written for MIKBUG would run in SMARTBUG without 
modification. As shown in the list below, all the locations 
of the most frequently used routines are maintained. 


THE FOLLOWING LABELS IN SMARTBUG ARE FUNCTIONALLY EQUIVALENT 
TO THOSE IN MIKBUG AND ARE LOCATED AT THE SAME ADDRESS LOCATIONS. 


_ io <POWDWN > LOAD LOAD3 LOAD11 LOAD15 
LOAD 19 LOAD21 cl <BADDR) CBYTE) OUTHL 
OUTHR <OUTCH ) <INCH) PDATA2 <PDATAL) <CHANGE> 

. CHA51 CINHEX) INLHG <OUT 2H ‘OUT2HA> (COUT4HS) 
GUT2HS> <OUTS) <STARTD (CONTRLD SFE) CINEEE> 

COUTEEE) ‘IOV BEGA ENDA NIO SP 
XHI™ XLOW TEMP TW XTEMP STACK 


THE FOLLOWING LOCATIONS IN MIKBUG ARE NOT FOUND AT THE SAME 
LOCATIONS IN SMARTBUG AND THERE MAY BE NO FUNCTIONALLY 
EQUIVALENT LABEL IN SMARTBUG. 


PRINT C2 MTAPEL PUNCH PUNI11 PUN22 


PUN23 PUN32 PUNT2 MCLOFF MCL _ SAV 
IN1 IN3 IOUT ouT1 IOUT2 Ios 
DEL DE CKSM BYTECT MCONT 


LIMITED WARRANTEE 


Any purchaser of SMARTBUG who is not satisfied with its 
performance may return his copy within 10 days from date 

of purchase for a full refund. This warrantee is in lieu 

of all other warrantees express or implied. SMOKE SIGNAL 
BROADCASTING does not warrant the suitability of SMARTBUG 

for any particular user application and will not be responsible 
for damages incidental to its use in a user system. 
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LICENSE CONDITIONS 


Purchase of a P-38 series board which includes SMARTBUG or 
purchase of a SMARTBUG listing conveys to the purchaser a 
license to copy SMARTBUG for his own use, and not for sale 
or free distribution to others. No other license, express 
or implied, is conveyed. 


LIMERICK 


Mary had a little plane. 
She flew it high and brisk. 
Wasn't she a silly girl, 
her little * 


USER CONTRIBUTIONS 


Any user wishing to contribute program or limerick improvements 
should send them to: : 


SMOKE SIGNAL BROADCASTING 
P.O. BOX 2017 
HOLLYWOOD, CA 90028 


We are particularly interested in extended monitor commands 
for possible inclusion in a future 2K or 4K monitor program. 
Worthwhile contributions will also be published in future 
newletters with credit to the author. 
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= TPP PIPL 
ECOO Sa 2T Bu ¢- Ere ens 
° Ee BF 1m © Eve PRT LS 
001 SMARTBUG =o 3r 3) terran Ruler + "aoa 
Bape ‘vecrers 
NAM — SMARTBUG 
* "SMARTBUG" — AN INTELLIGENT MONITOR 
* COPYRIGHT 1977 SMOKE SIGNAL BROADCASTING 
OPT 0,8 
8008  ACIAS EQ $8008 
8009 ACIAD EQ $8009 
E000 ORG  — $E000 
# I/O INTERRUPT SEQUENCE 
E000 FE A000 10 LDX IOV 
E003 6E 00 JMP =X 
# NMI SEQUENCE 
E005 FE AQ06 POWDWN LDX = NIO GET NMI VECTOR 
E008 6E 00 UMP =X GO TO NMI LOCATION 
* LOAD ASCII FORMATTED TAPE 
EOOA LOAD EQU . 
EQOA 86 55 LDA A #$55 READER RELAY ON, ONE STOP BIT 
EOOC B7 8008 STA A ACIAS 
EOOF 86 11 LDA A #$11 
E011 8D 62 BSR  OUTCH  AC-30 READ CTRL 
E013 8D 63. LOAD3 BSR INCH GET CHARACTER 
E015 81 53 CMP A #'S IS IT AN "Ss" 
E017 26 FA BNE LOAD3 NO-LOOP TILL "S" FOUND 
E019 8D 5D BSR INCH YES - GET NEXT CHARACTER 
EO1B 81 39 CMP A #'9 IS ITA "9" 
E01D 27 25 BEQ  LOAD21 YES - JUMP TO CONTROL 
EOIF 81 31 CMP A #"1 IS ITA "1" 
£021 26 FO BNE LOAD3 NO = TRY AGAIN 
E023 7F AQ6A CLR -CKSM YES = ZERO CHECKSUM 
£026 8D 2D BSR ‘BYTE GET A BYTE 
£028 80 02 SUB A #2 
E02A B7 AO6B STA A BYTECT READ THIS MANY BYTES 
* BUILD ADDRESS 
E02D 8D 18 BSR BADDR 
* STORE DATA 
E02F 8D 24  LOADI1 BSR BYTE READ NEXT BYTE 
E031 7A AO6B DEC  BYTECT DECREMENT BYTE COUNTER 
£034 27 05 BEQ  LOADI5 IF 0, GET NEXT LINE 
E036 AT 00 STAA X ELSE, STORE DATA 
E038 08 INX 
£039 20 FY BRA —_—LOAD11 
E03B 7C AO6A LOAD15 INC ‘CKSM FORM 2'S COMPLEMENT 
E03E 27 D3 BEQ  LOAD3 IT SHOULD BE ZERO ' 
EOUO 86 3F LOADI9 LDA A #'? READ ERROR - PRINT 
E042 8D 31 BSR  OUTCH QUESTION MARK 
EOW4°  LOAD21 EQU# 
E044 7E EOE3 C1 JMP —- CONTRL 


* BUILD ADDRESS 
EO47 8D OC BADDR BSR BYTE READ 2 BYTES 
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00640 
00650 
00660 
00670 
00680 


00700 
00710 
00720 
00730 
00740 
00750 
00760 
00770 
00780 
00790 
00800 
00810 
00820 


00840 
00850 
00860 
00870 


00890 
00900 
00910 
00920 
00930 
00940 
00950 


00970 
00980 
00990 
01000 
01010 
01020 
01030 


01050 
01060 
01070 
01080 
01090 
01100 
01110 
01120 
01130 
01140 
01150 
01160 
01170 


XHI AND RETURN FROM THIS 
BYTE SUBROUTINE WITH BOTH 
XLOW BYTES IN THE INDEX 
XHI REGISTER. 


* INPUT BYTE (2 HEX CHARACTERS) 


INHEX GET 1ST HEX CHAR 


INHEX GET 2ND HEX CHAR 


CKSM UPDATE CHECKSUM AND 
CKSM RETURN WITH BYTE IN 
A ACCUMULATOR 


OUT HEX LEFT BCD DIGIT 


#$F OUT HEX RIGHT BCD DIGIT 
#$30 


_ #$39 


OUTCH 

#7 

OUTEEE OUTPUT A CHARACTER 
INEEE INPUT A CHARACTER 


* PRINT DATA POINTED TO BY INDEX REGISTER . 


OUTCH 


x 
#4 END OF STRING CHARACTER 
PDATA2 


BADDR GET MEMORY ADDRESS 
#MCL 
PDATA1 PRINT C/R L/F 


#XHI 

OUT4HS PRINT ADDRESS 
XHI 

OUT2HS PRINT OLD DATA 
XHI 


INCH INPUT A CHARACTER 
#$20 IF IT'S A SPACE 
CHA51 GET NEXT ADDRESS 


002 SMARTBUG 

E049 B7 AOOC STA A 
EO4C 8D 07 BSR 
EOUE B7 AOOD STA A 
E051 FE AOOC LDX 
E054 39 RTS 
E055 8D 53 BYTE BSR 
E057 48 ASL A 
E058 48 ASL A 
E059 48 ASL A 
EO5A 48 ASL A 
E05B 16 TAB 
E05C 8D 4c BSR 
EQSE 1B ABA 
EO5F 16 TAB 
E060 FB AO6A ADD B 
E063 F7 AO6A STA B 
E066 39 RTS 
E067 44 OUTHL LSR A 
E068 44 LSR A 
E069 44 LSR A 
E06A 44 LSR A 
EO6B 84 OF OUTHR AND A 
E06D 8B 30 ADD A 
EO6F 81 39 CMP A 
E071 23 02 BLS 
E073 8B 07 ADD A 
E075 7E E1D1 OUTCH JMP 
E078 7E E1AC INCH JMP 
EO7B 8D F8 PDATA2 BSR 
EO7D 08 INX 
EO7E A6 00 PDATA1 LDA A 
E080 81 04 CMP A 
E082 26 F7 BNE 
E084 39 RTS 

* CHANGE MEMORY 

E085 8D CO CHANGE BSR 
E087 CE E3F1 CHAS1 LDX 
EO8A 8D F2 BSR 
E08C CE AOOC LDX 
EO8F 8D 37 BSR 
E091 FE AOOC LDX 
E094 8D 34 BSR 
E096 FF AOOC STX 
E099 8D DD BSR 
EO9B 81 20 CMP A 
EO9D 27 E8 BEQ 
EOSF 7E E3AD JMP 


TDEX ELSE - GO TO TDEX 
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01190 EOA2 AT 00 
01200 EOA4 A1 00 
01210 EOA6 27 DF 
01220 EOA8 20 96 


01240 

01250 EOAA 8D CC 
01260 EOAC 80 30 
01270 EOAE 2B 94 
01280 EOBO 81 09 
01290 EOB2 2F OA 
01300 EOB4 81 11 
01310 EOB6 2B 8C 
01320 EOB8 81 16 
01330 EOBA 2E 88 
01340 EOBC 80 07 
01350 EOBE 39 


01370 EOBF A6 00 
01380 EOC1 8D A4 
01390 E0C3 A6 00 
01400 E0C5 08 

01410 EOC6 20 A3 


01430 EOC8 8D F5 
01440 EOCA 8D F3 
01450 EOCC 86 20 
01460 EOCE 20 A5 


01480 

01490 EODO 
01500 EODO 8E AOu2 
01510 EOD3 BF A008 


::° 01520 EOD6 7F A0OB 


01530 EOD9 86 03 

01540 EODB B7 8008 
01550 EODE 86 15 

01560 EOEO B7 AOOA 
01570 EQE3 B6 AOOA 
01580 EOE6 B7 8008 
01590 EOE9 8E A042 
01600 EOEC 7F A011 
01610 EOEF CE E3FO 
01620 EOF2 8D 8A 


01640 EOF4 8p g2 
01650 EOF6 7F AO14 
01660 EOF9 16 
01670 EOFA 8D DO 
01680 EOFC CE £3C3 
01690 EOFF E1 00 
01700 E101 27 OB 
01710 E103 08 
01720 E104 08 


SMARTBUG 


CHA61 STA A 


x STORE NEW DATA 
CMP A X DID IT STORE CORRECTLY? 
BEQ  CHA51 —-YES = GET NEXT ADDRESS 
BRA LOADI9.- ‘NO = JUMP CONTROL 
* INPUT HEX CHARACTER 
INHEX BSR INCH 
SUB A #$30 
BMI C1 NOT HEX, JUMP CONTROL 
CHP A #9 
BLE —_INIHG 
CHP A #$11 
BMI C1 NOT HEX 
CMP A $16 
BCT C1 NOT HEX 
SUB A #7 
INIHG RTS 
OUT2H LDA A X OUTPUT 2 HEX CHAR 
OUT2HA BSR  OUTHL.=—sOUT_ LEFT HEX CHAR 
LDA A X 
INX 
BRA  OUTHR ~—OUTPUT _RIGHT HEX CHAR 
OUTHHS BSR  OUT2H ~~ OUTPUT 4 HEX CHAR AND SPACE 
OUT2HS BSR = OUT2H OUTPUT 2 HEX CHAR AND SPACE 
OUTS LDA A #$20 OUTPUT SPACE 
BRA OUTCH 
* POWER ON SEQUENCE ah 
START EQU # Sie 
LDS — #STACK 
STS SP 
CLR ECHO / ECHO ALL INPUT CHARACTERS 
LDA A #3°~ = MASTER RESET OF ACTA 
STA A ACIAS 
INZ LDA A #$15 SET UP FOR 1 STOP BIT 
INZ1 STA A ACIAT 
CONTRL LDA A ACIAT ALLOW FOR SOFTWARE CONTROL 
STA A ACIAS OF ACIA CONTROL REGISTER 
LDS  #STACK 
CLR  TFLAG TURN OFF TRACE MODE 
LDX  #MCLOFF 
BSR PDATA1 
BSR INCH —sINPUT COMMAND CHARACTER 
CLR  BKFLG = CLEAR BREAKPOINT INDICATOR 
TAB 
BSR OUTS 
LDX  #FUTABL DO TABLE LOOKUP 
NXTCHR CMP B 0,X FOR COMMAND FUNCTIONS 
BEQ  GOODCH MATCH FOUND 
INX NO MATCH-INC TO NEXT COMMAND 
INX 


ey 

Fan 

= 
om 
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01730 
01740 
01750 
01760 
01770 
01780 
01790 


01810 
01820 
01830 
01840 
01850 
01860 
01870 
01880 
01890 
01900 
01910 


01930 


01950 
01960 
01970 
01980 
01990 
02000 
02010 
02020 


02030. 


02040 
02050 
02060 
02070 
02080 
02090 
02100 
02110 
02120 
02130 
02140 
02150 
02160 
02170 
02180 
02190 
02200 
02210 
02220 
02230 
02240 
02250 
02260 


#TBLEND END OF COMMAND TABLE? 
NXTCHR 


NO - GET NEXT CHARACTER 

YES - CHECK FOR A, B,C,X CMNDS 
GET COMMAND LOCATION 

AND JUMP THERE 

KEEP SFE AT $E£113 


* ENTER FROM SOFTWARE tg 
STS SP 


SAVE PROGRAM'S STACK POINTER 


* DECREMENT PROGRAM COUNTER 


004  SMARTBUG 

E105 08 INX 
E106 8C E3FO CPX 
E109 26 F4 BNE 
E10B 7E E2D9 JMP 
E10E EE 01 GOODCH LDx 
E110 6E 00 JMP 
E112 01 NOP 
E113 BF AQO8 SFE 

E116 30 TSX 
E117 6D 06 TST 
E119 26 02 BNE 
E11B 6A 05 DEC 
E11D 6A 06 DEC 
El1F 7D A011 TST 
E122 27 63 BEQ 
E124 7E E38c JMP 


PRNT 
SWIURN 


IF TRACE IS OFF 
IF TRACE IS ON 


* PUNCH = OUTPUT HEX FORMATTED TAPE 


E127 8D 74. PUNCH BSR LIMITS 
E129 86 12 LDA A #$12 
E12B BD E075 JSR OUTCH 
E12E FE A002 LDX BEGA 
E131 FF AQOF STX TW 
E134 B6 AOOS PUN11 LDA A ENDA+1 
E137 BO A010 SUB A TW+1 
E13A F6 AOO4 LDA BENDA 
E13D F2 AOOF SBC B Tw 
E140 26 oO4 BNE PUN22 
E142 81 10 CMP A #16 
E144 25 02 BCS PUN23 
E146 86 OF PUN22 LDA A #15 
E148 8B O4 PUN23 ADD A #4 
E14A B7 AQ64 STA A MCONT 
E14D 80 03 SUB ; #3 
E14F B7 AQOE STA TEMP 

* PUNCH c/R, ai NULL,S,1 
E152 8D 77 BSR CRLF 
E154 08 INX 
E155 8D 77 BSR PDAT1 
E157 5F CLR B 

* PUNCH FRAME COUNT 
E158 CE A064 LDX #MCONT 
E15B 8D 25 BSR PUNT2 

* PUNCH ADDRESS 
E15D CE AOOF LDX #TW 
E160 8D 20 BSR PUNT2 
E162 8D 1E BSR PUNT2 

* PUNCH DATA ; 
E164 FE AOOF LDX TW 
E167 8D 19 PUN32 BSR PUNT2 


GET LIMITS 
AC=30 CONTRL 


THE "P" COMMAND JUMPS To 
PUNCH AFTER USING THE LIMITS 
SUBROUTINE TO ENTER THE 
START AND STOP ADDRESSES 


FRAME COUNT THIS RECORD 


BYTE COUNT THIS RECORD 


ZERO CHECKSM 


PUNCH 2 HEX CHAR 


PUNCH ONE BYTE 
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02270 
02280 
02290 
02300 
02310 
02320 
02330 
02340 
02350 
02360 
02370 
02380 
02390 
02400 
02410 
02420 


02440 
02450 
02460 
02470 
02480 
02490 
02500 
02510 
02520 


02540 
02550 
02560 
02570 
02580 
02590 


02610 
02620 
02630 
02640 
02650 
02660 
02670 
02680 
02690 
02700 
02710 


02730 
02750 
02760 
02770 
02780 


02800 


005 SMARTBUG 

E169 7A AOQOE DEC 
E16C 26 F9 BNE 
E16E FF AOOF STX 
E171 53 COM B 
E172 37 PSH B 
E173 30 TSX 
E174 8D OC BSR 
E176 33 PUL B 
E177 FE AOOF LDX 
E17A 09 DEX 
E17B BC AQO4 CPX 
E17E 26 BY BNE 
E180 20 47 BRA 
E182 EB 00 PUNT2 ADD B 
E184 7E EOBF JMP 


E187 20 61 PRNT BRA 


E189 8D 36 BKPNT . BSR 
E18B FF A068 STX 
E18E A6 00 LDA A 
E190 B7 A014 STA A 
E193 86 3F LDA A 
E195 A7 00 STA A 
E197 8D 32 BSR 
E199 BE A008 CONTG LDS 
E19C 3B RTI 
E19D 8D 22 LIMITS BSR 
E19F FF A002 STX 
E1A2 8D 05 BSR 
E1A4 8D 1B BSR 
E1A6 FF AOO4 STX 


E1A9 7E EOCC OUS JMP 


TEMP 
PUN32 


DECREMENT ONE BYTE 


PUNCH CHECKSUM 
RESTORE STACK 


GO TO CONTROL 


GET BREAKPOINT ADDRESS 


SAVE INSTRUCTION AND 
SET BREAKPOINT FLAG 


SET BREAKPOINT 


RESTORE PGM'S STACK POINTER 
GO TO USER'S PROGRAM 


GET FIRST ADDRESS 


OUTPUT A SPACE 
GET SECOND ADDRESS 


OUTPUT A SPACE & RETURN 


* INPUT ONE CHARACTER INTO A ACCUMULATOR 


E1AC 8008 INEEE LDA A 
E1AF 4 ASR A 
E1B0 24 FA BCC 
E1B2 B6 8009 LDA A 
E1B5 84 7F AND A 
E1B7 81 7F CMP A 
E1B9 27 F1 BEQ 
E1BB 7D AOQOB TST 
E’BE 2F 11 BLE 
E1CO 39 RTS 
E1C1 7E EO47 BAD2 JMP 
E1C4 SF ECHON CLR B 
E1C5 50 PRNTON NEG B 


E1C6 F7 AOOB ECHOFF STA B 
EiC9 20 41 C3 BRA 


E1CB CE E3A4 CRLF  LDX 


ACIAS 


INEEE 
ACIAD 
#S7F 
#$7F 
INEEE 
ECHO 
OUTEEE 


BADDR 


ECHO 
C2 


#CRLFAS 


TEST RECEIVE DATA REG FULL 
FLAG AND LOOP TILL IT IS SET 


GET DATA 
ELIMINATE PARITY BIT 


IGNORE RUBQUTS 
| 


GET ADDRESS 


ECHO ALL INPUT CHARACTERS 
TURN PRINTER ON 

DO NOT ECHO 

GO TO CONTROL 


C/R L/F WITHOUT ® PROMPT 
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SMARTBUG 


SIGNIFIES TRACE MODE 


FROM A~REG 
IF ECHO IS NEGATIVE, 
GO TO PRINTER ROUTINE. 


TEST TRANSMIT DATA 
REGISTER EMPTY FLAG 
AND LOOP TILL SET 


OUTPUT DATA TO ACIA 
RESTORE B-REG 


GET LOCATION OF JUMP 
GO TO USER'S PROGRAM 


CONDITION CODES 
B ACCUMULATOR 

A ACCUMULATOR 
INDEX REGISTER 
PROGRAM COUNTER 


IF IN TRACE MODE 

STACK POINTER 

GET INSTR TO REPLACE BKPNT 
NO BREAKPOINT SET 


REPLACE BREAKPOINT 


GET START & END ADDRESSES 
GET DESIRED CONTENTS 
IST ADDRESS TO INDEX REG 


FILL MEMORY FROM A REG 


LOOP UNTIL DONE 
GO TO CONTROL 


WHEN IN TRACE MODE 

DISPLAY S-POINTER THAT 
WILL BE USED WHEN EXECUTING 
THE DISPLAYED INSTRUCTION 


02810 E1CE 7E EO7E PDAT1 JMP  PDATA1 
02830 * QUTPUT ONE CHARACTER 
02840 E1D1 7D AOQOB OUTEEE TST ECHO - 
02850 E1D4 2C 03 BGE OUTCH2 
02860 E1D6 7E(AONA) JMP —- PRINTR 
02870 E1D9 37 OUTCH2 PSH B 
02880 E1DA F6 8008 OUTCH1 LDA B ACIAS 
02890 E1DD 57 ASR B 
02900 E1DE 57 ASR B 
02910 E1DF 24 F9 BCC OUTCH1 
02920 E1E1 B7 8009 STA A ACIAD 
02930 E1E4 33 PUL B 
02940 E1E5 39 RTS 
02960 E1E6 8D D9 ~=JUMP BSR BAD2 
02970 E1E8 6E 00 JMP =X 
"02990 .- * PRINT CONTENTS OF STACK 
03000 E1EA FE AOO8 PRINT LDX SP 
03010 E1ED 08 INX 
03020 E1EE 8D 44 BSR OUT2 
03030 E1FO 8D 42 BSR QUT2 
03040 E1F2 8D 40 BSR OUT2 
03050 E1F4 8D 3C BSR OUTT4 
03060 E1F6 8D 3A BSR OUTTY 
03070 E1F8 CE A008 LDX  4SP 
03080 E1FB 7D A011 TST  TFLAG 
03090 E1FE 26 21 BNE PRINTS 
03100 E200 8D 30 BSR OUTTH 
03110 E202 B6 A014 ~LDA A BKFLG 
03120 E205 27 05 -BEQ C2 
03130 E207 FE A068 LDX — PB2 
03140 E20A AT 00 STA A X 
03150 E20C 7E EOE3 C2 JMP —- CONTRL 
03170 E20F 8D 8C IFILL BSR LIMITS 
03180 E211 8D 7F BSR BYT 
03190 E213 FE A002 LDX — BEGA 
03200 E216 09 DEX 
03210 E217 08 FILLOP INX 
03220 E218 A7 00 STAA X 
03230 E21A BC AQO4 CPX ENDA 
03240 E21D 26 F8 BNE  FILLOP 
03250 E21F 20 EB C5 BRA C2 
03270 £221 E600 PRINTS LDAB X 
03280 E223 A6 01 LDA A 1,X 
03290 E225 8B 07 ADD A #7 
03300 E227 C9 00 ADC B #0 
03310 E229 F7 AOOE STA B TEMP 
03320 E22C B7 AOOF STA A TEMP+1 
03330 E22F CE AOOE LDX = #TEMP 
03340 E232 20 63 OUTTY BRA  OUTY 
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E234 7E 


E237 8D 
E239 8D 
E23B FE 
E23E F6 
E241 E7 
E243 B6 
E246 AT 
E248 7C 
E24B 8E 
E24E 8D 
E250 7F 
E253 FE 
E256 EE 
E258 FF 
E25B BD 


03860 E2A8 8D 
03870 E2AA FF 
03880 


SMARTBUG 


OUT2HS 


BAD2 


EOCA OUT2 JMP 
* TRACE ROUTINE 
88 TRACE BSR 
90 BSR 
A008 LDX 
AQOC LDA B 
06 STA B 
AQOD LDA A 
07 STA A 
A011 INC 
AQ60 RETURN LDS 
9A BSR 
A065 CLR 
A008 LDX 
06 LDX 
AOOC STX 
E1CB JSR 
A00C LDX 
34 BSR 
A0O0C LDX 
00 LDA B 
CA BSR 
00 LDA A 
A068 STA A 
01 LDA A 
A069 STA A 
A067 STA B 
8D CMP B 
12 BEQ 
8C CMP B 
25 BEQ 
8E CMP B 
21 BEQ 
CE CMP B 
1D BEQ 
FO AND B 
20 CMP B 
OD BNE 
A065 BBR INC 
16 BRA 
E055 BYT JMP 
88 Ch BRA 
EOC8 OUT4  JMP 
60 NOTB CMP B 
0c BCS 
30 AND B 
30 CMP B 
O4 BNE 
Fl BYT3 BSR 
02 BRA 
8A BYT2 BSR 
AQOC BYT1 STX 


XHI 


GET START ADDRESS OF TRACE 
AND SAVE IN XHI & XLOW 


PUT START ADDRESS IN 
PROGRAM COUNTER POSITION 
IN STACK 


SET TRACE FLAG 

SEPARATE STACK FOR TRACE 
DISPLAY ALL REGISTERS 
CLEAR BRANCH FLAG 


GET PROGRAM COUNTER FROM STAC 
AND SAVE IN XHI AND XLOW 


DISPLAY PROGRAM COUNTER 
AND FIRST BYTE OF 
INSTRUCTION 


STORE 2ND BYTE OF INSTRUCTION 
IN PB2 AND 3RD BYTE IN PB3 
IF INSTRUCTION IS LONGER 
THAN ONE BYTE 

BSR? TEST FOR SPECIAL CODES 
CPX? 

LDS? 

LDX? 

TEST FOR RELATIVE BRANCH 
TYPE INSTRUCTIONS 

SET BRANCH FLAG 

TWO BYTE INSTRUCTION 

GO TO conTroL | 

IS CODE LESS THAN 60? 

YES - 1 BYTE INSTRUCTION 
ONLY 3 BYTE WILL FALL THRU 
DISPLAY 2 BYTE OPERAND 


DISPLAY 1 BYTE OPERAND 
SAVE LOCATION OF NEXT INSTR 


* XHI NOW CONTAINS NEXT INS LOCATION 
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03890 
03900 
03910 
03920 
03930 
03940 
03950 
03960 
03970 
03980 
03990 
04000 
04010 
04G20 
04030 
04040 
04050 
04060 
04070 
04080 
04090 
04100 
04110 
04120 
04130 
04140 
047150 
04160 
04170 


04180 E 


04190 
04200 
04210 
04220 
04230 


O42H0 E 


04250 
04260 
04270 
04280 
04290 
04300 
04310 
04320 
04330 
08 240 
04350 
04360 
04370 
04380 
04390 
o4400 
O4410 
04420 


008 


SMARTBUG 


E2AD 7D A065 


E320 
E322 


27 19 
F6 A068 
2c 02 
86 FF 


BQ AOOC 


BD E1AC 


FE A008 CKCBA 
08 


C1 43 
27 OA 


C1 58  CHKX 


A7 05 
7D AOi1 RETDID 
26 BF 
20 87  RETNOT 


E C6 3F = DOT 


B6 A067 

81 8D 

26 0B 

FE A061 

FF AQOC 

TF A065 

20 59 ‘ 
7D A065 TSTB 


IS IT A BRANCH? 
NO 
YES, COMPUTE TARGET LOCATION 


TEST FOR BRANCH BACK 

FF FOR BACKWARD BRANCH 
ADD OPERAND TO LOWER 

8 BITS OF PROGRAM COUNTER 
SAVE TARGET ADDRESS 


DISPLAY TARGET ADDRESS 


GET COMMAND 
SAVE IN B REGISTER 


IF SPACE EXECUTE THE 
INSTRUCTION. IF NOT A 
SPACE, TEST FOR A CHANGE 
REGISTER COMMAND. NOTE, THIS 
PART OF MEMORY IS SHARED 
WITH THE CHANGE REGISTER 
COMMANDS WHEN NOT IN TRACE 
MODE. IF IT IS A CHANGE 
REGISTER COMMAND WHILE IN 
TRACE MODE, RETURN TO 
NOTBB FOR NEXT COMMAND. 


DISPLAY REGISTER CONTENTS 
SAVED IN STACK 

GET NEW CONTENTS 

AND STORE IN STACK 


DISPLAY INDEX es 
GET HIGH 8 BITS 


STORE IN STACK 

GET LOWER 8 BITS 

STORE 

IN TRACE? 

YES, GET NEXT TRACE CMD 
RETURN TO CONTROL 

SWI CODE TO B-REG 

GET INSTRUCTION 

IS IT A BSR? 

IF YES, NEXT INSTRUCTION 
WILL BE AT ADDRESS STORED 
IN BPOINT. 

ONLY ONE SWI NEED BE SET 
SET BKPOINT AND EXECUTE INST 
IS IT CONDITIONAL BRANCH? 
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04430 E325 27 OC 
O444O E327 FE A061 
O4450 E32A AG 00 
O4460 E32C B7 A063 
O4470 E32F E7 00 
O4480 E331 20 48 
04490 E333 81 6E 
04500 E335 27 14 
04510 £337 81 AD 
04520 £339 27 10 
04530 £33B 81 7E 
OU540 E33D 27 04 
04550 E33F 81 BD 
04560 E341 26 1C 
04570 E343 FE A068 
04580 E346 FF AOOC 
04590 E349 20 30 
04600 E34B FE A008 
04610 E34E A6 05 
04620 E350 BB A068 
04630 E353 B7 AOOD 
04640 £356 A6 O04 
04650 E358 89 00 
O4660 E35A B7 AOOC 
04670 £35D 20 1C 
O4680 E35F FE A008 
04690 E362 81 39 
O4700 E364 26 04 
04710 £366 EE 08 
O4720 E368 20 06 
04730 E36A 81 38 
O4740 E36C 26 05 
O4750 E36E EE OD 
04760 E370 FF AQOC 
04770 E373 81 3F 
04780 E375 27 95 
04790 E377 81 3E 


. 04800 E379 27 91 


04810 E37B FE AOOC 
04820 E37E A6 00 
04830 E380 B7 A066 
O4840 E383 E7 00 
04850 E385 E1 00 
04860 E387 26 83 
04870 

04880 E389 7E E199 


04900 

04910 E38C FE AQOC 
04920 E38F B6 A066 
04930 E392 AT 00 
O4940 E394 7D A065 
04950 E397 27 08 
04960 £399 FE A061 


TSTJ CMP A 


ISJ LDX 


ISX LDX 


NOTJ LDX 


B 
NOTRTS CMP A 
EXR STX 
NOTRTI CMP A 


EXEC LDX 


BNE 


TSTJ 
BPOINT 
xX 
BPOINT+2 
x 

EXEC 
#$6E 
ISX 
#$AD 
ISX 
#$7E 
ISJ 


OPSAVE 
X 


xX 
RETNOT 


* EXECUTE INSTRUCTION 


JMP 


CONTG 


"RETURN HERE ON SWI IF 


SWTURN LDX 


XHI 
OPSAVE 
x 
BFLAG 
DISPLY 
BPOINT 


YES, SET BREAKPOINT AT 
TARGET ADDRESS IN CASE 
PROGRAM GOES THERE. 

SAVE INSTRUCTION 

SET SWI AT TARGET ADDRESS 


INDEXED JUMP INSTRUCTION? 
INDEXED JSR? | 
STRAIGHT JUMP? 
STRAIGHT JSR?’ 


PUT NEXT INSTRUCTION 
ADDRESS IN XHI & XLOW 


COMPUTE NEXT INST ADDRESS 
FOR INDEXED JUMPS 


IS INSTRUCTION AN RTS? 
NO 


YES, PULL RETURN ADDRESS 
FROM STACK AND STORE IN 
NEXT INSTRUCTION POINTER. 


SWI? ; 
YES, RETURN TQ CONTROL 
WAI? 


YES, RETURN TO CONTROL 

SET BREAKPOINT AT NEXT 
INSTRUCTION LOCATION AND SAVE 
STORE SWI AT BREAKPOINT & 
VERIFY THAT IT'S WITHIN RAM 
IF ROM, GO TO CONTROL 


RTI TO EXECUTE INSTRUCTION 
TRACE FLAG ON 

REPLACE SWI'S WITH PREVIOUS 
CONTENTS. IF BFLAG IS CLEAR, 


THEN ONLY ONE BREAKPOINT 
WAS SET. 
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04970 
04980 
04990 


05010 


05030 
05040 
05050 
05060 
05070 
05080 
05090 
05100 
05110 
05120 


05140 
05150 
05160 
05170 
05180 
05190 
05200 
05210 
05220 
05230 
05240 
05250 
05260 


05270 E 


05280 
05290 
05300 
05310 
05320 
05330 


05340 E 


05350 
05360 
05370 
05380 
05390 
05400 
05410 
05420 


010 SMARTBUG 


E39C B6 A063 
E39F AT 00 


E3A4 OD 
E3A5 OA 
E3A6 00 
E387 00 
E3A8 00 
E3A9 04 
E3AA 53 
E3AB 31 
E3AC O4 


E3AD 81 55 
E3AF 27 OA 
E3B1 BD EGAC 
E3B4 BD E057 
E3B7 09 

E3B8 TE EOA2 
E3BB 09 

E3BC 09 

E3BD FF AQOC 
E3CO 7E E087 


E3EA 45 
E3EB E1C4 


LDA A BPOINT+2 
STA A X 
E3A1 7E E24B DISPLY JMP 


CRLFAS FCB 


TDEX 


CHA71 


FUTABL 


CMP 
BEQ 
JSR 
JSR 
DEX 
JMP 
DEX 
DEX 
STX 
JMP 


EQU 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 
FCC 
FDB 


RETURN DISPLAY REGISTER STATUS 
$D,$A,0,0,0,4,'S,'1,4 


#'U IF IT'S A "U" 

CHAT1 GET PREVIOUS ADDRESS 
INHEX+2 IF NOT HEX, JMP CONTROL 
BYTE+2 ELSE, GET NEW DATA 


CHA61 STORE NEW DATA 
GET PREVIOUS ADDRESS 


XHI 

CHA51 PRINT PREVIOUS ADDRESS 
“a COMMAND LOOKUP TABLE 

/M/ 

CHANGE MEMORY EXAMINE 

/G/ 

CONTG GO TO $A048 

/R/ 

PRINT § PRINT REGISTERS 

/T/ 

TRACE TRACE ROUTINE 

/%/ 

IFILL MEMORY FILL 

/K/ 

BKPNT SET BREAKPOINT 

/4/ 

$E400 GO TO $E400 

/3/ 


JUMP JUMP TO ADDRESS ENTERED 
$8020 QUICKSTART ~ BOOT DISC 
$7283 DISC WARMSTART 

PRNTON SET HARDCOPY FLAG 

LOAD LOAD ASCII FORMATTED TAPE 
PUNCH PUNCH ASCII FORMATTED TAPE 
ECHON TURN INPUT ECHO ON 
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05430 
05440 
05450 


05470 
05480 


05500 
05510 
05520 
05530 


05550 


05570 
05580 
05590 
05600 
05610 
05620 
05630 
05640 
05650 
05660 
05670 
05680 
05690 
05700 
05710 
705720 
05730 
05740 
05750 
05760 
05770 
05780 
05790 
05800 
05810 
05820 
05830 


011 


E3ED 
E3EE 


E3FO 
E3F 1 
E3F2 
E3F3 
E3F4 
E3F5 
E3F6 
E3F7 


E3F8 
E3FA 
E3FC 
E3FE 


A000 
A000 
AGO2 
A004 
A006 
AG08 
AOOA 
AOQOB 
AO00C 
AOOD 
AOOE 
AQOF 
A011 
AOi2 
A014 
A015 
AOQY2 
AON3 
A060 
A061 
AO64 
A065 
A066 
A067 
A068 
A069 
A06A 


SMARTBUG 


NE 
E106 
E3F0 


0002 
0001 
0002 
0001 
002D 
0001 
001D 
0001 
0003 
0001 
0001 
0001 
0001 
0001 
0001 
0001 


05840 AO6B 0001 


05850 


AOYA 


FCC 
FDB 
TBLEND EQU 
MCLOFF FCB 
MCL FCB 
FDB 
FDB 
FDB 
FDB 

* RAM STORAGE 
ORG 
IOV RMB 
BEGA RMB 
ENDA RMB 
--NIO RMB 
SP RMB 
ACIAT RMB 
-ECHO RMB 
XHI RMB 
XLOW RMB 
TEMP RMB 
TW RMB 
TFLAG RMB 
XTEMP RMB 
BKFLG RMB 
RMB 
STACK RMB 
RMB 
TSTACK RMB 
BPOINT RMB 
MCONT RMB 
BFLAG RMB 
OPSAVE RMB 
PBI RMB 
PB2 RMB 
PB3 RMB 
CKSM RMB 
BYTECT RMB 
PRINTR EQU 


/N/ 
ECHOFF 
* 


$13 


TURN INPUT ECHO OFF 


$D,$A,$14,0,0,'#,4 


7D, #4, @, v, esti 


10 IRQ VECTOR 
SFE SWI VECTOR 
POWDWN NMI VECTOR 
START RESET VECTOR 
LOCATIONS 

$A000 


g 


I/O INTERRUPT POINTER 
BEGINNING ADDRESS 
ENDING ADDRESS 
NMI INTERRUPT POINTER 
TARGET STACK POINTER 
ACIA STATUS WORD 
ECHO FLAG 
INDEX REG HI 
INDEX REG LOW 
TEMP 
TEMP 
TRACE FLAG 
X-REG TEMP STORAGE 
BREAKPOINT FLAG 
SMARTBUG STACK 
STACK POINTER 

Aoys 7 ACEO 
TRACE MODE STACK 
BRANCH POINT ADDR & CODE 
TEMP 4 
BRANCH FLAG (TRACE) 
OPERAND (TRACE) 


TRACE TEMP 
TRACE TEMP 
TRACE TEMP 
CHECKSUM 
BYTE COUNT 
USER PRINT ROUTINE 
74 : 
75 
76 
be 
7 ¥ 
ot 
4 A 
FR 
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05870 END 


SP A008 

ACIAS 8008 PDAT1__E1CE ACIAT AOOA 
ACIAD 8009 ] ' ECHO  AOOB 
0 E000 OUTCH2 E1D9 XHI  AOQOC 
POWDWN E005 QUTCH1 E1DA XLOW  AOOD 
LOAD EOOA JUMP  E1E6 TEMP AOOE 
LOAD3 £013 PRINT EEA TW AOOF 
LOAD11 E02F C2 E20C TFLAG A011 
LOAD15 E03B IFILL E20F XTEMP A012 
LOAD19 EOUO FILLOP E217 BKFLG A014 
LOAD21 E044 C5 E21F STACK AON2 
C1 EouY PRINTS E221 TSTACK A060 
BADDR £047 OUTTY E232 BPOINT A061 
BYTE E055 OUT2 £234 MCONT A064 
OUTHL £067 TRACE £237 BFLAG A065 
CUTHR: E063 RETURN E2UuB OPSAVE A066 
QUTCH E075 BBR —- E28D PB1 A067 
INCH £078 BYT £292 PB2 = A068. 
PDATA2_ EO7B cy E295 PB3 A069 
OUTS E297 CKSM .AO6A 
CHANGE E085 NOTB E29A BYTECT A06B 
CHA51 E087 BYT3  E2A4 PRINTR AOSA 
CHA61 EOA2 BYT2 E28 

INHEX EOAA BYT1 E2AA TOTAL ER 
IN1HG EOBE DPOS £E2BA pepe Woes 0 
COUT2H EOBF) NOTBB E2CB 

OUTCHA E0C1 CKCBA E2D9 

RDC —- E2EB 

C OUT2HS EOC) CHKX  E2F5 

RETDID E307 

START EODO RETNOT E30C 

INZ ODE DOT  £30E 

INZ1__ EQEO TSTB £322 
CCONTRL EOES> TSTJ £333 

NXTCHR E ISJ E343 

GOODCH E10E ISX  E34B 

SFE E113 NOTJ £35F 

PUNCH E127 NOTRTS E36A 

PUN11 E134 EXR E370 

PUN22 E146 NOTRTI E373 

PUN23 E148 EXEC £37B 

PUN32 E167 SWTURN E38C 

PUNT2 E182 DISPLY E3A1 

PRNT E187 CRLFAS E3A4 

BKPNT E189 TDEX E3AD 

CONTG £199 CHA71 E3BB 

LIMITS E19D FUTABL E3C3 

OUS 1A9 TBLEND E3FO . 

MCLOFF E3FO 

BAD2 ~~ E1C1 MCL ___E3F1 

ECHON E1CH 

PRNTON E1C5 BEGA = A002 

ECHOFF E1C6 ENDA A004 


C3 E1C9 NIO A006 


